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TASMON • MONITOR PROGRAM FOR THE TRS-ttO 



With TASMOF (The Alternate Source's Monitor), memory may he 
examined/modified and machine language programa executed. Machine 
language programs may be run in real tine, elngle etep or alow Motion. 
Tour Z-RO reenters way be examined/modified . They are continuoualy 
dieplayed in the upper right part of the acreen. Three different 
memory dumps can be displayed on the left aide of the screen while 
executing any TASMON command on the right aide of the acreen. Memory 
can be disassembled and routed to dlak or tape aa an Fdi tor/Aaaemhler 
source file with labels generated for pertinent addresses. SYSTEM 
tapes and machine language disk filea can be read in and written out. 



TASMON FORMATS AND CONVENTIONS 

All numbera displayed by TASMON are hex unless otherwise' noted. 

In all examples given below, uaer inputs are underlined. 

The version of TASMON on the distributed diskette or tape loads in 
memory from 600O-7FFF with an entry point of 6000. 

There is also ■ short machine language program titled "TF.ST/CMD" which 
is uood in the seseions discussed st the end of this manual. 

For the most part, TASMON uses single letter commends and the KNTER key 
is not needed. The FREAK key may be depressed at any time to exit a 
command (except when writing/loading files to/from diak or tape). The 
LEFT ARROW does not backspace the cursor (unless Inputting a file name) 
so hit the BREAK key and reenter the command if a mistake is made. 



When a four or two digit 
zeros must be entered. 



number is being input, any and all leading 



TASMON uses its own keyboard, video and printer routines. If a key is 
held down, after a pause it will start repeating'. The video display 
supports upper/lower case. If no lower caae mod ia installed, ell 
lower case characters are converted to upper caee. 

When TASMON is entered, the user's etack pointer is set at 41FE. The 
user may change it as needed provided it does not Interfere with 

TASMON. 

The register display appears on the the right aide of the acreen in 
this formatt 



CALL 01 C9 

IX 52Afl IT F29A 

AP' E23A BC* 1550 



( I 



DE' 06FA HL* BC09 

AF 0044 BC 02RA 

PR D9R0 KL 3DF5 

SP 41K4 PC BOOO 

-Z P— (HL) ¥¥ 

The top Una 1b the Zilog disassembled raneraonio of the Instruction 
pointed to by the PC regleter (8000 In this case). The four digit hex 
number following each register pair la the current value of that 
regleter pair. The last line of the display la the atatua of the Z-flO 
flage (F register).. A "-" indicates that the bit ie cleared. The "FF" 
following "(HL)" Is the value found at the current address of HL. In 
this caee "FF" Is at memory location 1DF5. All user Inputs are done on 
ths eight lines below the register display. 

MEMORY USAGE 

TASMOH uses approximately 8K of memory. Some ROM routines srs used to 
decrease program site. Mo RAM outside of TASMOH is used with the 
exception of the symbol table when disassembling to dialc or tsps and 
the user's screen memory when using the KERP SCREEH command. 

LOADING AND REENTERING TASMON 

For executing the program from disk, type the following from DOSi 

TASMOH 

The Z-flO registers and the right srrow ussr prompt will be displsysd. 

To load a taps version of TASMOH typst 

> SYSTEH 
•? .TASMOH 
•? /<ENTEB> 

Ths dlsplsy will be the same ss with ths disk version. 

If TASMOH is sxitsd for soms reason there are two ways to reenter the 
sonitori 

1) Go to BASIC end typei 

>SYSTEH 



•7 /start addreae 

(here "start addr 
iss located in memo 

2) With a DOS system enter DEBUG and type; 



where "start address" is the decimal starting address of where TASMON 
was located in memory. 



a 



G start address 

wIL?! art addrea °" lB the h " 8tartln * add "" of ■■»•*• TASMOH was 
located in memory. 

When TASMON ia reentered in this manner ths user's register, srs not 
changed. However, any breakpoints that wers s«t srs ols.red. 

EXITING TASMON 

The "E" or EXIT command Is used to lesvs TASMOH. To sxeouts this 
command enters w*»wu*» mis 

E <ENTER> 

Ir't^I™^ ne6 * a t0 ** prea8ed ■" ' Bafetr Precaution to prevent 
•tlting the monitor unexpectedly. Do not EXIT when disk "rivs. !rm 
turning or the computer will lock up. ™ 

TASMON COMMANDS 



REPLACE REGISTERS 

liTZs c ^ an the ch fij:; a v f r- w "»*•*•»• *° - •». 

(the aec'ond lit e . a so reou ^ r^rM "f'vT «" lr to * Chan « ad 
digit regiater Value An L2T I f 1! and U) > and the n « *™r 

name if the Joo*W..{ la Jo Z* ' ' ^ *"" * h * ™« UUr P-*' 
follows, 8econ<1<ir y set is to be changed. The display will appa^a. 

set HL to 09AF 
set AF' to 2044 



MODIFY MEMORY 

The Modify memory command allows the uh«p *« », 

RAM. To execute the command press "M« !". "a- ^T, th * conte °t» of 

to be in ASCII or hex mode) ?£"«! bv th..^* ^ (f ° r -"««tio« 
ENTER koy ia depressed for the iLl th \ a<,dreaa to ■«■">. If ths 
address is used foV thJ^ta'rUn'g^dlJ^^o^^i:^ ^ ~ rf " 1 * 

revised » the c. rriflg , ^^-r-^fJ-.JJ. ^ J-JJ^ 



values Into an addreaa. The current contents of the modification 
addreaa will be diaplayod in the format: 

APPRES3 ASCII HEX 

i 

Where "APPRf\."S" ia the memory addreaa being modified, "ASCII" ia the 
ASCII value of the byte at "APWFSS" (only diBplayed if the value ia 
between 20-7F) and "HEX" la the hex value of the byte. 

To change the contents of ADPRFSS, type in a new two digit hex value or 
one ASCII character depending on which modification mode waa aelected. 
The up arrow will leave the current addrena unmodified and move up in 
memory one byte. The down arrow will move down in memory one byte. To 
exit, hit the FREAK key. A typical display 1st 



n H 707F C 43 AE 



7080 82 <UP ARR0W> 
707P AE <BRF,AK> 



Hex modify mode, address Is 707F, 
ASCII value of byte at that addreaa 
Is "C", the hex value Is 43 and the 
byte waa changed to AE. 
Hove up one byte 
Exit modify mode 



MEMORY DUMPS 



Thar* are thrae memory dumps in TASMONt 

1 ) Hexadecimal dump 

2) ASCII dump 

3) Plaaaaembled dump 

All three dumpe are Initiated by preening the appropriate command key 
followed by a four digit hex value where the dump la to etart. 
Pressing the FFTER key instead of the four digit atarting value causes 
the dump to begin at the current PC regiater. The acreen will clear 
and 15 llnea of the dump will be dlaplayed. 

Pressing the SPACE BAR at this point causes the next IS lines to be 
displayed. The BOwN AFR0W la uaed to display the next line. Preeaing 
the "-" key causes the display to move back In memory 15 lines (70H 
bytea with ASCII and Hex dumps, 15 Instructions with disassembler). 
Holding down any of theae command keya will cauae them to repeat. 
Preasing the BREAK key, aa alwaya, returns control to command mode. 

HEX DUMP 

The hex dump will display the hexadecimal values of memory starting 
with the addreaa entered. For example i 

H 5200 ^ 

will causa thia typ* of diaplay to appear on fifteen lineal 



5200 45 AF 20 OF C3 DD 00 FP 
5208 }4 AH FF FF 99 03 FA 00 

The 5200 la the addreoa and 45 Is located there; 5201 holda AF, etc. 

ASCII DUMP 

The ASCII dump will diaplay 20-7F values as the appropriate ASCII 
character. All other values are dlaplayed in hex. For example! 

A FOOC 

will cauae this type of display on fifteen lineal 

FOOC THE00 03B0T 



DISASSEMBLED DUMP 

The Piaaasembled dump will display memory in Zilog aneaonlca. Thi. 
dump makea reading programs much easier. For examplei 

D 0000 

will^cauae the acreen to clear and fifteen lines Ilka the following to 



0000 FE 

0001 AF 

0002 C37406 



DI 

XOR 

JP 



A 

0674 



lull l 2 5 "*» Bi * r * Ba9 * are «-pl«7«« tf'ing their da.tination addraa. 
Hike an abaolute jump) instead of a relative offaet. 

wh^r 1 -»,i n ! tr ;K ti0 :! "I* di " 8 "" bl «« J «ith "DEPB hV.a th. instruction 

where h is the offending byte. For example! 

8000 CB 

8001 3007 



PEFB 



CB 
NC.800A 



DISASSEMBLED LISTING TO PRINTER 

£« «~=^- ! « 5££ 2=*,£ Mrs 

^^s^^JsrjMrr^A -=. -a* * 

atop. If this command is executed and the printer i. not rt.dy! 
control returns to TASMOIf with nothing printed. For example, 

P OOgO OOFO Diaassembla to the printer atarting at 



n 



0000 and ending at 00P0. 



DUMP SCREEN CONTENTS TO |>H INTER 

* 
Pressing the "* M key while TASMON is waiting for keyboard input (except, 
when a file name is being entered) will cause the current screen 
display to be sent to the printer. If the printer ia not ready at the 
time the "•" is pressed, nothing is printed and control returns to 
TASMON. Graphics characters are printed as periods. 



SUM/SUUTHACT HEX VALUES 

This command will either sum or subtract two four digit hex values. 
Press "S" and two values followed by a "♦" for sua or a "-" for 
subtract. The second value is added to or subtracted froa the first. 
For example t 

S 0100 8023 ♦ 81.23 
S ECOQ 0100 "£ EBOO 

FIND CONSECUTIVE BYTES IN MEMORY 

The find command will locate positions in memory where from 1 to 4 user 
specified two digit hex digits occur. 

To run the commend press "F", the stsrting address of the search end 
from 1 to 4 two digit snsrch bytes. If less thsn 4 bytes are Inp^j 
the ENTER key must be depressed to start the search. Pressing "P" 
followed by ENTER will find the next occurence of the last seerch key 
entered. 

The address where the bytes were found is printed sfter the command 
line. If no value is printed, there were no more occuranoes of the 
search key in memory. For example: 



F 0000 AF 54 <EHTEB> 4176 



F <ENTER> 87FE 



F <EHTER> 



find where AF 54 resides in 

memory starting at 0000. First 

occurence wss at 4176 

find next occurence of AF 54. 

Found to be et 87FE 

no value printed so no mors 

occurances 



WOTBi the FIND command will always locate at least one occurence of 
the March key aince the search key is stored in TASMON. 



r 



ZERO A IIEOCK OF MEMORY 

The "Z" or ZERO MEMORY command is used to set s block of memory to some 

value. To execute ZERO MEMORY, press the "Z" key, a starting address, 

an ending address and a two digit hsx valus to he written into the 
block. For examplei 



Z POOP F050 54 
Z POOO F050 00 



will set memory from FOOO through 
F050 to 54. 

will set memory from FOOO through 
F050 to 00. 



SKIP OR HACK UP ONE INSTRUCTION 



To move the user's PC register to the next instruction without 
executing the current instruction press ths RIGHT ARROW key. To move 
back to the previous instruction press ths LEFT AEROW key. These 
commands sllow an instruction to be easily repeated or skipped. For 
example: 



If the user's 
memory: 



PC rsgister holds ROOO and the following code is in, 



7FFD 2110F0 
0000 110000 
6003 C3B392 



LD 
LP 
JP 



HI..F01/) 
DE.0000 
9283 



Pressing the LEFT ARROW would movs the PC register back one instruction 
or to 7FFD. Pressing the RIGHT ABPOW would skip ths Instruction at 
8000 and move PC to 8003. 



USER ROUTINE. 

Thia command is undefined by TASMON. It allows the ussr to dsflns a 
routine to be executed by pressing ths "U" ksy. If the "U" key is 
pressed without s user routine present nothing happens. To put a uaer 
routine in place, TASMON muat be changed via the MODIFY MEMORY command 
so it will jump to ths routine. The first step ia to find whsrs in 
memory to modify. TASMON checks for commands with the following type 
of code: r 



CP 
JP 



•u' 

Z, ADDRESS 



To patch in a user routine the addreee at "ADDRESS" must be changsd to 
the entry address of ths uBsr's routine. To find whsrs to modify sntsr 
ths following: 

I 600 ° Z£ 55 CA <ENTER> 6085 

Ths FIND command Just found the firat occurence of the menu sslect 
routine for the "U" key. The 6000 address should be substituted with 



the starting addrees of TASMON (6000 in this case). The FB 55 is a "CP 
'U'" Z-80 instruction, and the CA is the first byte of the "JP 
Z, ADDRESS" instruction. 

To patch the user routine in place, MODIFY MFMORT In hex at three plus 
the addreee returned by FIND (thla is the Jump addrees). low type in 
the entry addreee of the user routine in Z-RO format (LSP first, MSB 
last). 

The patched version of TASMON can be written to disk or tape. Refer to 
the VP.ITF command discussed below for Instructions on how to do so. 

To return from the user routine to TASMOI! simply do a Z-PO "RFT" 
instruct loo (assuming the stack pointer has not changed).. 

The USER function will be supported by various routines in the future. 



CLEAR SCREEN 



The dear screen command will clear the video display and redisplay the 
Z-80 registers. To execute this command press the CLEAR key. 

RELOCATE AND MOVE MEMORY 

The RELOCATE command allows a machine language program to he moved from 
one location to another. All necessary Jumps and loads within the 
range of relocation are changed. This command can be used to move 
TASMON from one location to another. RFLOCATE can move many other 
machine language programs to new execution addresses. 

To RFLOCATE memory, preea an "X" followed by the starting point of the 
move, the ending point of the move and the starting address of where 
the code is to be moved to. RELOCATION takes about 6 seconds per 4K of 
memory moved. 

Suppose a program was loaded in memory from 8000 to 9FFF and we want to 
move it to EOOO to PFFF. The command flow would go like this I 



J 8000 9FPF EOOO 



RELOCATE from 8000 to 9FFF 
and move it to EOOO 



HOTE: The RELOCATE command will function correctly if code is 
overlapped. However, it -ill not allow TASMON to be overlapped while 
relocating. 

For example, if a program resides from 8000 to 9FFF and ia relocated to 
."new sJariing address of 9000. the relocated code will ««•*•" 
9000-APFP. The relocated version overlaps the origin memory block or 
8000 to 9FPF. Thla typa 
except TASMON. 



reroiuii u""»i'" »■— ~--o--- — - - 

of relocation will work with all programs 



8 



./ 



A problem can occur when relocating. For example, 
following code was in memoryi 



suppose the 



8000 210080 
8005 CD6000 



LD 
CALL 



BC.8000H 
0060H 



Supposs we relocated memory from 8000 through 80FF to EOOO. The eode 
at EOOO would appear as follower 



EOOO 2100BO 
E003 CD6000 



LD 
CALL 



BC.OEOOOH 
0060H 



If 8000 was a pointer to a text message, the change from 8000 to EOOO 
would be correct, but in this cess the 8000 was a stall value since the 
ROM call to 0060 ia a stall routine. The change from 8000 to EOOO in 
effect doubles this stall. 

There are other occurences of this type. Another is when a register 
pair is loaded with, for eiample, the number of bytee to read from a 
disk file. If this number is changed the results could be disaaterous. 

Even with these two potential problems, RELOCATE does function with 
most programs. 



MOVE A DLOCK OF MEMORY 

To HOVE a block of memory from one location to another uae the T" 
command. The command parameters are the same as for the RELOCATE 
(etarting addrees, ending address and new starting addrees) command. 
This command simply copies memory from one location to another. The 
move routine is "emart" enough to allow code to overlap. For example i 



T FOOO F035 EOOO 



Hove memory from FOOO through 
to F0J5 to EOOO 



r 



input/output 

The author of TASMON chose , to make the program's disk I/O file oriented 
rather than sector oriented as most other monitors. This allows a disk 
file to be loaded into RAN and then written hack out as a SYSTEM tape. 



LOADING SYSTEM TAPES AND CMD DISK FILES 



To LOAD a SYSTEM tape into memory press the "L" 
and hit ENTER or a four digit offset value. 



key, a "T" (for tape), 



If the ENTER key is depressed, the module will load into memory 
normally. If an offset value was entered, this value is added to tha 
load addresses of the tape and data is loaded at the new 'address. -The 
reason for this offset value is that tapes loading at addresses 
4000-51FF will destroy DOS. If DOS is not intact, TASMON can not write 
or read disk files. If the load is offset so it does not interfere 
with DOS, TASMON diek commands will function normally. For example i 

L T <ENTER> Load a SYSTEM tape 
T T 4000 Load a SYSTEM tape and add 4000 
to its load addresses. 

The file name of the SYSTEM tape la displayed when loading. 

To LOAD a CMD file from diek press the "L" key, the "D" key signifying 
disk, the ENTER key or a load offset and a filename. For example: 

L 2 <ENTRB> I*« d the file TEST/CMD into memory from disk 
TEST/CMP * 

After a module is loaded, the starting, ending and transfer addresses 
are displayed In that order. A typical load display would be: 

L T <ENTER> 
FOOO F035 F010 

The starting addresa of the module is FOOO, the ending address is F035 
and the transfer address is F010. 



If a SYSTEM tape is offset, use the SUBTRACT command to figure where it 
would normally load by subtracting the load offset from the starting, 
ending and transfer addreesea. If the module would interfer with DOS, 
the ueer la left with two optional 



1 ) Enter the block move program given below 

2) H« 



2) Relocate the program 
The. block move program discussed here will oreate a module like thoae 



\ 



10 



made with Apparat e LMOFFSET. This code will move the module to its 
correct starting address and start it running. To enter this appendaire 
program MODIFY MEMORY in he, mode starting on. byte sft.r th.l2j£ 
address of the module Just loaded. ^ 



The block move program appears as followai 



21 xx rx 

It yy yy 

01 ZE tt 

ED BO 

C3 tt tt 



LD 

I.D 

LD 

LDIR 

JP 



HL, starting address 

DB, starting addrees - offset 

BC, ending address - starting addresa ♦! 

transfer address - offset 



An example of this procedure would be as followai 

L T 2000 

^350 6BFA 6500 

i, S l™" ll Pe "!? l0ad ° d With "" 0ff8et of 2000 ' Th « Parting addreea 
Juhfr m th ; K end i" g addre88 l8 fiB ™ •<«> the transfer addreea is 6S00. 
?" " C "" g h the °""* or < 2000 fro " th «« *■!»•■ «lve. 4350. 4BFA and 

SSi SI r T? Uld 4nt ! Ffere " ith W3 (J>03 '» hl « h "»°n -Idreas U 
51 FF). The following bytes would be entered as the appendage projra. 
starting at 6BFB, or one byte after the ending sddress of the ax.-nl! 
tape, with the MODIFY MEMORY commandi ° f th * •" B P 1 « 

21 50 63 11 50 43 01 71 09 ED BO C3 00 45 

In Z-80 anemonloa, the program isi 

LD HL.6350 

LD DE.4350 

LD BC,0971 

LDIR 

JP 4500 

Notice that "xx", "yy", -„-, and - tt - wn aub8tltuted b _ th ., 

appropriate values. In this case 6350 for "„', 4350 for -J," «t7 

.t.rtin, .ddre.. la th. .... aim:, no cod. ... .dd.d to th. oaf „„ 
P o. th. Pr °f. r °'i h '.J °Z " ,d '1 "**— >" ,"" «tfl-l -tM Us .. 
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The ••cond option of relocating the program may not always work for 
reaaona diecuened under RELOCATE. 

Tha module loaded above will be used aa an example of thle procedure. 
The starting, ending and transfer addresses were 6350, 6BFA and 6500 
respectively. 

The first step la to block move the nodule from its offset location to 
Its normal eiecutlng location. In this case the module 1b located from 

6350 to 6BPA and should be at 4350 to 4PFA. These numbers are figured 

by subtracting the load offset from the offset starting, ending and 

transfer ad.ireaHee. In thin case the 43^0 in derived by nuMractlng 

POOO from M r >P, etc. The "T" block move is uaod move the program to 
its normal addressee as follows: 



T 6350 6PFA 4^50 



move monory from 6350 through f.PFA 
to memory otnrting at 4350 



Bow the program is at ita normal execution location, 4350 through 4BFA. 
DOS has also been overwritten so all TASKON disk commands are now 
disabled. 

How the RELOCATE command can be .used to move the program up to high 
memory and change all necesssry instructions of the program so it will 
run at high memory. Suppose we wanted to move It so It would start at 
7350. The "X" command would be used as follows: 



X 4350 4BFA 7350 



relocate memory from 4350 through 
4BFA to memory, starting at 7350 



How the program reeldee at 7350 through 7BFA. The entry address can be 
found by adding the relocate offset to the original entry address. In 
this caae the relocate Afreet ie 3000 (7350 - 4350) and the original 
entry addreea la 4500 which glvee a new entry address of 7500. 

To verify that the relocated version of the program functiona 
correctly, type the following: 



G 7500 



Start execution at 7500 ("G" is dlacuased 
below) 



If the relocated vereion of the program la to be written back out to 
diak. press the RESET button to reboot DOS and write the file ° ut vJ"» 
described in the WRITE command instructions. The -tartlng. ending and 
tranafer addreeaea of the relocated vereion are 7450, 7BFA and 7500 
reapeotively. 



Moat, but not all program* will function 
proceaa. When a program la found not to 
block move technique deecrlbed above. 
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correotly when moved by thia 
work when relocated, uee the 



VIEW A FILE 

The VIEW command ia almillar to the LOAD command in that it returns the 
starting, ending and transfer addresses of a disk or tape file, except 
the VIEW command does not load the file into memory. 

To execute the VIEW command press "V" and a "T" for tape or "D* for 
disk. If tape wan selected no other parameters are entered. If diak 
was selected a file name must be entered. For example: 

V n 

C HESS/CH D 
7000 PKA3 7535 

The file "CHESS/CMD" wan VIEWed from disk. The starting, ending and 
transfer addreaaea were found to be 7000, APA3 and 7535 respectively. 

Memory from 70°0 to PFA3 wnn not modified however. 



10TF: it is good practice to VIEW a file befbre LOADing 
the module will not load over TASMON. 



It to verify 



WRITING OUT A SYSTEM TAPE OH CMD DISK FILE 

To^write a file out press "W" (for WRITE) followed by a "T" for tape or 
a "D" for disk. The starting, ending and entry addresses are entered 
next In that order. Lastly, tho filename ia entered, up to aix 
characters for tape or a DOS filename for diak. When entering a file 
name the SHIFT BACKSPACE does not function. The BACKSPACE must be 
repeatedly pressed or held down to get to the beginning of the line. 

If the above block move example waa to be written to diak the following 
would be keyed In: 



W D 6350 6C08 6BFB 

file7chd 



Write to disk starting at 6350, 
ending at 6C08 with an entry of 
6BFB. Use the file name 
"FILE/CUD" 



DISASSEMBLED OUTPUT TO DISK OR TAPE 

The OUTPUT command will disassemble to diak or tape aa an 
Editor/Aanembler source file. The code sent to diak or tape la alao 
echoed on the screen. To execute this command preaa the "0" key (for 
OUTPUT), a "D" for disk or "T" for tape, the etartlng, ending and. 
transfer addreaaea of the dump. A filename ia alao entered. 

A symbol table ia generated by TASHOIf to ease the reading of the dump. 
The eymbola are created for all 16 bit addreaaea between the starting 
and ending addreaaea apeolfied. This table a tart a at the high memory 



IS 



r 



pointer located at 4049-404A and builds downward in memory. If there 
la a program running in high memory make sure thia pointer la aet to 
auch a value that the program will be protected. If TASMON ia moved to 
high memory there will be about 100 bytea free for the symbol table. 
The aymbol table uaea two bytea per label. If large aoounta of memory 
■re being disaaeembled, there could be • pause of several seconds while 
the symbol table is being generated. 

The starting addreas given will be uaed as the address of the ORG 
pseudo-op. The ending addreas Is simply where output will halt. The 
transfer address is the address placed on the END pseudo-op. 

Any teit meaaagea dumped to disk will be sent as Z-80 instructions. 
Therefore, some work may be required by the user to generate the proper 
source code In this case. 

The source is written out with line numbers of 00000. Therefore, the 
first command eieouted from Editor/Assembler after the sou roe ham been 
loaded In would be REJIUHBER (i.e. H 100,10). 

r 
The command format goes am followst 

D FOOO F035 F010 



TEST/ASH 



Output to disk starting at FOOO, 
ending at F035, and entry addreas 
of F010. 
Use the file name "TEST/ASM" 



The symbols TASNOJI generatea are simply the address in question 
proceeded by ■ "Z". For example, ■ typical label would bet 



Z0046H 



CALL 2002BH 



Bad symbols can be generated In eome instances where text messages and 
■tall or counter values are uaed. For example, if the following code 
waa in memory t 

8000 21 

8001 00 

8002 IF 

8003 10 

8004 FD 

The bytes at 8000 and 8001 could be the last two bytes of a text 
message. The instruction at 8002 is a RHA. The instruction at 8003 is 
a DJHZ and the offset at 8004 refers back to B002. However, when this 
cod* is disassembled out it would appear as follows t 



LD 

DJHZ 



HL.IFOOH 
Z8002H 



The aymbol "Z8O02H" ia never defined oinco the inatruction at 8002 wao 
Incorreotly dieaaaembled as the moat significant byte of the "LD HL,nn" 
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instruction at flOOO. The aolution for this proble 
symbol ZflOOPH" to the addreas M R002H\ The sour 
appear incorrect but reaeaembling the aourc, will giv. correct'results! 



is to change the 
source code will atill 



J2I TRS^ \J I °f «ver occurs with TASMON, .„ , rror maBBg9 tnd 

enJ IJ 2? f°J* (in h6x) iS prjLnte ' 1 - "•'•* t0 *PP*"dix A .i the 

end of this manual for a list of error mesoages. 



BREAKPOINTS 

I AS m«!!hf!r\ th9 UHeP C ° ntr01 ° Ver 9 breakpoints. A breakpoint allows 
Jr-Sfli ♦ TT J™*"" t0 * ttt °W at « Predetermined .pot Z* 
.'J ""J™ he to . TASM0N ' '" ""PL. if « breakpoint was let 

at 8000 and the user s program eiecuted the instruction at this 
addreas, control would be returned to TASMON. 

to re ;nfercent a t r he lab9l " d , " 9 " * thre * b ' U *«-kP»i-t (CALL nn) 
so intercept the user s program. 



is used 



One unique feature of TASMON is that the nunher of times a 
ia executed before halting may be aet for each hrmrt^iHE 



breakpoint 



SET ANI1 lltSI-L/tV I1REAKI1IIKTS 

To «|, breakpoint pp.,. - B " f„ll ..a hy th. br..kpolnt nu.b.r (!-<« 
Zi .1 Zl " l *l' V" »'" k P°">» ■»/ b. pl.c.d ,wl Lion 

dz< L j;r j: :.) vr^i -* rr •"•" -?-^ » 



1 8 80QE 

B <ENTER> 

41F3 01 0000 01 0000 01 
7B02 01 0000 01 0000 01 
0000 01 809E 18 0000 01 



seta breakpoint 8 to 809E 
diaplaya all breakpoints 



L™..; 01 ^ ™l ?»\ M "'" °" d tl " "•«■«•■ »»«bT 1. 1. breokpolnt 4 



is 



function correctly. Suppose s breakpoint In set at ROOO and another at 
BOOK They trill not function correctly since the three byte 
breakpotnte will overlap (POOO-A002 and 8001-000?) i 

Brkpnt 1 Brkpnt 2 



8000 


CALL 




flOOl 


lab 


CALI 


8002 


mab 


lab 


8003 




Binb 



SET NUMBER OF EXECUTIONS BEFORE IJJIKAK 

The "*N" or "Number of axecutlona before break" command allows netting 
the number of tinea a breakpoint la executed before the breakpoint la 
acknowledged. The default value la 01. Thla raeana execution will halt 
If the breakpoint la executed 1 time. 

The format a of tha command aret 

H n h Sat the number of executlona for breakpoint n 

"" to "h" (a value from OO-FF where 00 ie 2">6 

decimal). 

J! .1 Set the number of executlona for all breakpolnta 

"" "~ to 01 (or the normal number of executlona). 

H <CTTEH> Set all breakpolnta back to their aet valuea. 
""" Thia value will be 01 unloaa changed by the 

"If n h" command. 

Tha number of axecutlona value la uaed only by tha TRACE and GO 
commands (bftth dlacuaaed below), not by the alngle ateppers. Tha value 
la decremented each time the breakpoint la executed. When thia value 
reachea zero, execution halts and all execution numbera are reaet to 
their original valuea (01 unleaa changed by the "If n h" command). The 
"H <ENTFR>" command will alao reaet the valuea. 

Moat uaera probably will not uae thia command. If the execution number 
la left at 01, breakpolnta will function aa with any other monitor 
program. 

CLEAR BREAKPOINTS 

To clear a single breakpoint preaa "C" followed by tha breakpoint 
number (1-9). To clear all breakpolnta type "C" followed by ENTER. 
For example t 



£1 

C <E1TTER> 



will clear breakpoint 1 . 
will olaar all breakpolnta. 
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INSTRUCTION STF.P COMMANDS 

There are two typea of atep commands in TASMON, manual and automatic. 
Fach will atart at the location pointed to by the uaer'e PC reglater 
and roturn control to TASMON and diaplay the registers. The PC 
register should contain the execute addrona oT the uoer'e program. 

SINGLE STEP 

There are two types of single ntoppera in TASKONt 

1) otep next instruction with CAI.La executed in full. 

2) otep next instruction with CALLa atepped through. 

The first type of single atepper will execute one lnatructlon with 
CALLo executed in one atep. To execute thia command hit the DOWN ARROW 
key. The uaer'a registers will be rediaplayed upon return to TASMON. 
If a breakpoint ia aet within a CALL executed with thia atepper, the 
CALL will be executed only up to the point of the break. NOTEt a CALL 
to RON will not halt at a breakpoint within the CALL with thla atepper. 

The second type of single atepper will execute one inatruction with 
CALLa stepped through one inatruction at a time. Thla command ia 
executed by preaalng the "I" key. 

A unique feature of TASMON la that ROM instruction* may be alngle 
atepped by either type of alngle atepper. It ia recommended that the 
DOWN ARROW type (CALLa executed in full) be uaed since aome ROM 
routinea can take quite a while to execute. 



SINGLE STEPPING RESTARTS 

The Z-80 "RST" command la a apeclal single byte CALL. RESTARTS may bs 

atepped through or "executed in full." The DOWN ARROW and "I" keys 

are atill uaed to atep restarts, except the "J" or JUMP THROUCH 

RFSTARTS command ia used to determine how they are handled. If 

preaoing the "J" key displays a DOWN ARROW, restarts will be executed 

in full. If preaalng the "J" key diaplaya an "I", restarts will bs 

stepped through. For example: 



J I 
II 



Step through restart a mods is on 
Execute reatarta In full mode is on 



The status of restart stepping has no effsot on now CALLe are handled. 

: 0r » e !!" p1- ' CALL " Can U sU PP ed through while restarts are executed 
in full. 
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THACE COMMAND 

The Trace command will continuously single step the user's program and 
redisplay his registers. To Invoke this command press the "T" key. 
Next, enter the type or .stepping desired. A POWN ARROW is used to 
execute CALL* in full and an "I" for step through CALLs. For example: 



T I 



starts TRACK with calls stepped through 



The step rate can be varied from about 2 seconds per instruction to 15 
Instructions per second by pressing the 0-7 keys while TRACE la 
executing (7 is the fan test step rate). Everytime TRACE la entered the 
etep rate Is reset to one instruction per second. 

Traoe execution is halted by one of four ways: 

1) One of the 9 user breakpoints In hit and ths 
execution number is decremented to sero. 

2) The PREAK key is depressed (control returns to 
command mode). 

3) The SPACE BAR is depressed (execution pauses until 
the SPACE BAR is depressed again). 

4) A "RET" instruction was executed while the "RETURN 
BREAKPOINT" option was on. 



At times the user starts stepping through a CALL. When all the 
information needed is found, all the user wants to do is get out of the 
call. The "RETURN BREAKPOINT" option is a way of getting out of the 
CALL quickly. By pressing the "R" key while tracing, the "RETURN 
BREAKPOINT" option is turned on. When this option is on, the next Z-flO 
"RFT" or "RET cc" where the condition was met will halt TRACE 
execution. This option is like putting a "floating" breakpoint on 
"RET" instructions. The only way to turn this option off is to eiit 
and reenter TRACE. 



TASMON allows tracing through ROM if dealred (some of the routines take 

quite a while to finish) and breakpoints in RON are honored.. Some 

special conditions must be met for breakpoints in RON to halt the 
program however. 

If a CALL la used and a breakpoint is set somewhere within the RON 

CALL, tracing with CALLs executed in full will not halt on the 

breakpoint. Tracing with CALLs stepped through will halt if the 
breakpoint is hit.. 

For breakpoints in RON to function with the TRACE command, the address 
of the breakpoint muat be single stepped. When stepping through a 
CALL, all Instructions of the CALL are single stepped. When executing 
CALLs In full, the CALL is executed in its entirety in one step. 
Breakpoints oan not actually be loaded into RON, only RAM. Therefore, 



It 



tracing with CALLs stepped through is required to honor breakpoints 
within CALLs to ROM. l~*"« 



CO COMMAND 

The CO command will start the user's program at full apeed. 

The only way to halt the user's program is for a breakpoint to be 
executed until the execution number is decremented to aero. 

Since breakpoints can not really be set in ROM, CO will not halt 
execution in RON. 

To use the GO command, press a "G" followed by either a hex value where 
execution is to start or the ENTER key (execution start, at the uaer'a 
PC register). For example: 

will start execution at 8000 

will start execution at the PC register. 



To continue on from a breakpoint with CO do either of the following: 

1) Single step over the instruction where the break 
occured. 

2) Clear the breakpoint where the break occured then uae 
the GO comirand to continue on. 

One of these two steps is required since COing at a breakpoint addreas 
simply returns control to TASMON with none of the user's program 
executed. Single stepping over the instruction at the break address 
then allows the GO command to continue on normally until the next 
breakpoint is executed. 

NOTE: Nore than one instruction may need to be single stepped since a 
breakpoint uses three bytes. If GO execution is resumed in the middle 
or a breakpoint results can be unpredictable. 

IL th rn nUmber °J f" cutl0n8 for a breakpoint is set greater than one, 
the CO command will execute part of the user's program at full speed 
and single step part of it (single step enough of it to make sure 
execution does not resume in the middle of a breakpoint). The BREAK 
key may be depressed to halt execution while .ingle stepping if 



NOTE: TASNON does not allow an illegal 2-80 opcode to be single 
stepped or traced. Bad code is disassembled as "DEFB h." To run thie 
type of code, • breakpoint must be set after the instruction «4 the GO 
command used to etep it If so dealred. 
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keei'Scheen 



1) 


K start addreaa 


2) 
3) 
4) 


K <FNTFR> 
K Y 
K N 



TASMON usM columns 40 to 61 for lta diaplaya. However, aomo uaer 
programs may alao uae these locations. The "K" or "KEEP SCREEN" 
command may be uaed to save the screen before TASKON affects It. When 
the "KEFP SCREEN" option la enabled, the user's laat acreen will be 
redisplayed before single stepping, tracing of COinp. On return from 
one of the stepping commands the acreen will be reeaved. There are 
four formats of the "K" command as follows: 

nave acreen at "start address" . 
display user's screen 
turn KF.FP SCR FEN on 
turn KEEP SCREEN off 

The rirst option, "K start address", Is used to Initialise the KEEP 
SCREEN command. The four digit value "start address" la the starting 
address of a 1024 byte buffer In memory where the user's screen la to 
be saved. When the location Is entered the screen memory Is set to a 
clear acreen of 1024 Bpaces (2011). The ASCII option of the MODIFY 
MEMORY command may be used to set the screen to some initial condition. 

The second option, "K <ENTERi", will bring the user's saved screen tack 
to the video display and leave It there as long as the ENTER key Is 
held down. This option allows for a quick review or the user s 
display. 

The third option, "K Y", Is used to turn the KEEP SCREEN option on. 
Whenever a program la stepped with, this option on, the user's screen 
will be redisplayed and saved continuously. TASMON will not affect the 
user's screen at all. 

The forth option, "K F", is used to turn the KEEP SCREEN option off. 
The current saved acreen is not changed by turning the command off. 

The screen buffer may be cleared by the "K start address" option or the 
ZERO MEMORY command. Example inputs are: 

K FOOO Set user's screen buffer at F000-F3FK 

and clear the buffer (make it all spaces). 

K <ENTER> Display the current saved screen. 

X" y Turn the KEEP SCREEN command on. 

K W Turn the KEEP SCREEN command off. 

GENEHAL COMMENTS 

A commented listing of ths source code is available from the suthor for 
$15. The author's address is: 

Bruce G. Hansen 

220 Iris Street 

Lansing, MI 46917 

(517) 323-2260 
I 
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SINGLE STEPPING THROUGH BASIC 

A powerful feature of TASMON la that the BASIC interpreter written by 
Microsoft may be single stepped. 

This allows a BASIC program to be entered froa the keyboard and RUN. 
TASMON will step through the ROM routines of the BASIC Interpreter to 
perform these tasks. 

NOTE: Disk BASIC seems to have problems when single stepping in the 
manner described below. 

The first step is to get BASIC and TASMON co-resident in memory. Thla 
can be done a few ways: 

One way is to enter LEVEL II BASIC and set • MEMORY SIZE high enough to 
protect TASKON. Next, load TASMON via the SYSTEM command. Since 
TASMON takea about BK of memory, the memory siisa should be % 

16K mncbine - 24575 
32K machine - 40959 
48K machine - 57343 



Dink users can load TASMON from DOS and enter LEVEL II BASIC by 
pressing the BREAK key and RESET button. Next, enter the MEMORY SIZE. 

TASMON must be entered next. To do this types 

> SYSTEM 

•? /ntnrt address 



Where "start address" is the starting addreaa of TASMON. 

The next step is .to set a breakpoint at 41 B2. This the address of a 
CALL used by ROM to return to BASIC command mode. If this breakpoint 
is not set, any error from BASIC such as a SYNTAX or MISSING OPERAND 
error will cause TASMON to be exited. 

If TASMON is ever exited in this manner simply re-enter the monitor by 

typing: 

> SYSTEM, 

•? /ntart address 

The state of the Z-BO registers will remain unchanged. Therefore, 
stepping can continue froa where TASMON wee exited. 

RESTARTS aust be set to "step through" node. Press the "J" key until 
this mode is enabled. The "step through" node is on when an "I" is 
displayed after the "J" pressed by the user. 
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Now BASIC can be either single stepped via the DOWN ARROW key or 
key or TRACK mode. 



"I" 



If TRACK mode is selected' with CALLa executed in full and the "7" apeed 
option is selected (faateat TRACE step rate), BASIC will operate about 
5000 tines slower than normal. 

If CALLs ars stepped through, keyboard characters must be held down 
until the keyboard driver routine used by BASIC scans through then. 
After this there is a significant stall to eliminate keybounce at 0060. 
For these reasons CALLs executed in full is reconaended for stepping 
BASIC. 

The reentry address of BASIC is 1 A19- Modify ths PC register to this 
addreos before stepping BASIC as follow: 

R PC 1A19 



After TASMON has been patched in, BASIC will function normally. 

Some BASIC commands will not function correctly. For example, none of 
the tape or disk input/output commands will function correctly. 

The breakpoint at 41 B2 will be executed each time the ENTER key is 
pressed. This may be an irrlatlon, but ths breakpoint is required or 
stepping BASIC will not function correctly. 

When the breakpoint at 41 B2 is executed, simply continue tracing or 
single stepping by pressing the appropriate command key(s). For 
example, to continue with TRACK mode types 



II 



Pressing the BREAK key will exit BASIC and return to TASMOH. To 
continue stepping BASIC, simply continue traoing or single stepping by 
pressing ths appropriate command keys. 

Refer to SESSION 6 for more Information and an example of single 
stepping a BASIC program. 
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SAMPLE SESSIONS 

The following sample sessions are examples using TASMON 's commands. 

SESSION I • Load TASMON, rrttwair ii to high memory ami write il ba<-k out lo <li»k. 



The distributed version of TASMON loads from 6000-7FFF with an entry 
point of 6000. By distributing , the program in this form, only one 
vertilon is needed for a 16K, 32K or 46K machine. However, the owner of 
a'40K machine will probably want TASMON to run at high memory or 
EOOO-FFFF. To do this enter the following commands I 

From DOS enter TASMON by typings 

TASMON 

The Z-80 registers and user prompt will be displayed. 

Next use the RELOCATE command to move the program to memory starting at 
EOOO. The fornat 1st 



X 6000 7FFF EOOO 



which relocates memory from 6000- 
7FFF to memory starting at EOOO. 



Now TASMON reaidea at 6000-7FFF and at EOOO-FFFF. To snvs ths high 
memory version to disk use the WRITE command. The format is 8 

W D EOOO FFFF EOOO 
HTASMON/CMD 

Which dumps memory from EOOO-FFFF with a transfer address of EOOO to 
diak with the file name "HTASMON/CKD". 

Whenever "HTASMON" la typed in from DOS ths high memory version of the 
program will be exeouted. 
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SESSION 2 . U-a S^U S,«~ *of.-.~ . I.ARIIUAUE ,— pr^r.*. from ta pr. 

,t i. aaaumedtn thi. .«-pl. that TASMON reeidee in memory fro. 

8ooo-9 v ft. 

To load BARRICADE enter the following command. 

L T ?000 Lo«a • SYSTEM tape with an offset of 2000 

6~350~6"d£f 6350 ^ ' 

respectively. 

-r*. n«t eteo ie to enter LEVEL II BASIC in a non-DOS environment. To 

2 th" hold'down "he BREAK key and hit the RESET button. 

How reenter TASMON by keying in the following* 

irgJFfcfl Assuming TASMON etarte at 800011 (32768 

^ decimal). This addreas must be the same an 

the starting address of TASMON. 
How block move the program back down to its .ormal execution location 
with the BLOCK MOVE "I" command aa follows: 

I 6350 6D6F 4350 

n . « 5 d..ti„.Uon .odr... .« JjH-i * «.«-«»" «•' '- """' 
(2000) from the starting address (6350J. 

BARRICADE now reside- .t it- ?"««" T ° "^ " *° 

memory from 7350-7D6F enter the following. 

X 4350 4D6F 7350 

— f MII n«50-4I)6P to memory starting at 7350. 

the normal entry address of 4350. 

*. reoot.r DOS ., MtHw tt. »ES CT button «.!.. To r..n,.r T»oHO» 

type in: 

TASMON 

, * «. to write the * relocated version of the program to 
XriYn. 1 !— ff-- to accomplish this .s follows, 



24 



y 



1 D 7^0 7D6F 7350 
BARRIC/CMn 

Memory from 7350-7D6F was written to disk under the file name 
"BARRIC/CMD" with an entry addrees of 7350. 

To run the relocated version of BARRICADE type the file name of the new 
module from DOS. 
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SKSS.ON 3 • l-a . m-rhlnc !.«.«.** n.« fro* di.k .nd „~«,c 1. 1., .In,.* ..eppin* 

Irariiig and going. 

The abort progra. uaed In this ...-pie appears as follows. 



LOOP 



00100 
00110 
00120 

00130 

00140 

00150 

00160 

00170 

00180 STOP. 

00190 TEXT 

00200 

00210 

00220 



ORG 

LP 

LD 

INC 

CP 

JR 

CALL 

JR 

JP 

DEFM 

DFFB 

DEFB 

END 



5FO0H 
HI, TEXT 
A,(HL) 
HL 


Z.STOP 

033 AH 

LOOP 

STOP 

'THIS IS 

ODH 

00 

5F00H 



A TEST* 



j START OF PROGRAM 
{START OF TEXT 
;GFT A BYTE 
j POINT TO NEXT BYTE 
j END OF MESSAGE? 
5JIIMP IF END 
;¥HITE BYTF 
{GET ANOTHER BYTE 
;KEEP ON JUMPING 
{TEXT MESSAGE 
{CARRIAGE RETURN 
{MESSAGE PFLIMITER 
{ENTRY POINT IS 5F00 



1 message on the ecreen. In 

For this session TASMON la 

and the short program given 

"TEST/CMD". The distributed 

the mater diskette with the 



The purpose of thia program la to "rite 

Ihta ess. the -eesage ia "THIS IS A TEST 

assumed to be in memory from 6000-7FFP 

above is saved on disk under the file name 

copy of TASMON has both of these files on 

indicated load addreasss. 

The first step 1. to load the file into .e.orv. The LOAD command is 

used for this by keying ini 

L D <ENTER> 
TEST/CMD . 
5F00 5F20 5FO0 

The file "TEST/CMD" loaded fro. 5FOO-5F20 with an entry point of 5F00. 
The first ti.. through the program... will -i-pU -W 8t "P U ' 
Th. first step is to load the PC register with the starting address of 
The program or £oO. Use the REPLACE com-and to do this, 

R PC 5J00 

To aid in viewing the program, disassemble the progra. to the screen. 

This is dons by entering! 

D 5F00 

The screen should appear as follows 1 
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5F00 21 1 15F 


LD 


HI..5F1! 


5F03 7fi 


LD 


A, (ML) 


5F04 23 


INC 


XL 


5F0S FPOO 


CP 


00 


5F07 2005 


JR 


Z.5F0B 


5F09 CD3A03 


CALL 


033A 


5 FOG 10F5 


JR 


5F03 


5F0E C30E5P 


JP 


5F0E 


5F11 54 


LD 


D.H 


5F12 40 


LD 


C,R 


5F13 49 


LD 


C,C 


5F14 51 


LD 


P,E 


5F15 204Q 


JR 


NZ,5FfiO 


5F17 53 


LD 


D,F 


5F18 2041 


JR 


NZ.5F5B 



LD HL.5P11 

IX 4C41 H 094C 

AF* 4B43 BC° 4353 

DE' AA52 HL' OBOA 

AF OOFF BC 4C44 

DE 4C48 HL A070 

SP 41 B4 PC 5F00 

8Z1H1PNC (HL) 4C 



Notice that the labels used in the source code have been changed to 
■actual addresses, and ths teit message appears as Z-80 instructions. 

Hit the TWEAK key to exit the DISASSEMBLE mode and reenter TASMOR'a 
command mode. 

To single step the instruction at the PC register or 5F00 (which is a 
LD HI..5F11) hit the DOWN ARnOW or "I" key. The HL register pair will 
now have 5F1 1 in it, PC equals 5F03 and ths instruction at 5F03 (or PC) 
is LD A, (HL). 

Single step this instruction. The A register will hold 54 or an ASCII 
"T", the first character of the message. PC will now be 5F04. The 
next instruction is "INC HL". Single step PC again. HL equals 5F12 or 
the address of the next character of the message. 

PC now holds 5F05. The instruction there is a CP 00. This instruction 
checks for the end' of the meanoge which is a 00 byte. Single step this 
Instruction. Notice that the Z-80 flags changed (the Z flag will not 
be set because 54 does not equal 00). 

The next instruction is JR Z.5F0E which is where ths program Jumps if 
the message ia through being printed. 

The next inntruction la CALL 033A. PC points to this instruction by 
holding 5F09. This is a ROM CALL to display the character in the A 
register on the screen. To single step this instruction hit the DOWN 
ARROW key. If the "I" key is depressed the CALL will be stepped 
through one instruction at a time. You may want to try thia just to 
see how ROM writes the character on the screen* The routine does take 
some time to step through however. 

After the byte ia displayed on the screen the program jumps up to get : 
another character from the message. The proceds repeats until the 
entire message la displayed at which time the program merely Jumps upon 
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lteelf In an endless loop. 



Single stepping through the progra. by hand can take so.e time, but It 
is nec.—rj wL a progra. may have bugs present. The TRACE command 
can be used to single step through a section of cods at a hlghsr rate 
of speed while still displaying the Z-BO registers. 

Before running the TRACE command change the PC register back to the 
•tart of the program by entering: 

R PC 5 POO 

Ho- start TRACK by pre-slng the T" key. Next hit the DOWN ARROW key 
to select tracing with CALLs eiecuted in full. 

The progra. -Ill slngls step at about one instruction per second. 
Press the "4" key. Rotice that the progra. Is executing a little 
£"er/ The -peed control keys are 0-7 where 7 is the fastest ret.. 

Press ths BREAK key sfter the entire message has been P^ n J« d ; ™« 
entire program was just traced through. But suppose we want to , top 
the program every time it checks for the end of the message at 5F05 (CP 
00). ?o do thl7. BREAKPOINT csn be set. A breakpoint is analogous to 
• BASIC STOP command. 

Since we want to stop the program at 5F05. « breakpoint will be placed 
there. To eet a breakpoint type: 

B t 5fQ5 which sets breakpoint 1 at 5F05. 

Row eat the PC regiater back to the start of the program: 

B PC 5F00 

Start TRACE again by entering: 

li 

The progra. -topped when PC was 5F05 which was where our breakpoint- was 

set. Up to nine breakpoints can be set in this manner. 

Suppose we want to dlaplay the next five *"«ten. on the screen 

•Uhout having breakpoint t halt execution before each character ie^ 

displaysd. 

To do thia th. nu.ber of executions of breakpoint 1 -ust be set to 5 as 

follows: 

H 1 05 Set nu.ber of executions for breakpoint 1 to 05. 

Mow continue traoing by entering! 
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The first five characters were printed on the screen and the program 
stopped at the breakpoint again. To clear that breakpoint type: 



C 1 



which clears breakpoint 1 



If tracing ia continued at this point execution will not halt until the 
BREAK key is depressed. 

The CALL at 5P09 appears aa follows in ROM: 



033A 
033B 
033E 
033P 
0342 
0345 
0346 
0347 



PUSH 
CALL 
PUSH 
CALL 
LD 
POP 
POP 
•RBT 



DE 

0033 

AF 

0348 

(40A6),A 

AP 

DE 



Suppoae we want to obaenre the registers for so.e reason when PC ia 
033B. In order to observe the progra. at thia point a. breakpoint in 
RON must be set. To do this enter: 

1 1 °33 B which sets breakpoint 1 at 033B 

The number of execution for breakpoint ! was prevloualy eet to 05. To 
eet this and every other execution number to 01 enter: 



N I 



Initialize execution number, to 01 



Before tracing through the progra. the PC regiater mist be set to the 

beginning of the program: 

R PC 5FQ0 

Breakpoint* in ROH can only be "seen" by TA3H0M if the instruction 
where the breakpoint is set is single stepped. For exa.ple, if the 
following code was present in ROMs 



1000 LD 
1002 LD 
1004 RET 



A, 5 
B,6 



And a breskpolnt was set at 1002, the breakpoint would halt the progra. 
only if the Instruction at 1002 was single stepped. 

If a CALL 1000 instruction was exeouted the breakpoint would not halt 
the progra. if CALLs were executed in full (the instruction at 1002 
wojild not be single stepped), but it would halt execution if CALL* were 
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stepped through (each Instruction or the CALL ia elngle stepped). 

Therefore, for this breakpoint to work on TRACK we must specify CALLa 
stepped through as follows t' 

t 

T I 

The program will halt when PC equals 033R. Suppoae we want to step 
through instructions residing at 033R-0341 with CALLs executed in full. 
To do this est another breakpoint at 0342, or one inatruction after 
the CALL 0346 1 

B 2 0342 which seta breakpoint 2 at 0342 
Now eiecute TRACE with CALLa executed in full: 

II 

The program will halt at 0342 which was where our breakpoint was aet. 
If tracing was continued with CkU.a ateppod through the breakpoint at 
033B would halt the program. If CALLa are executed in full neither 
breakpoint will not halt the program for. reaaona diacuased above. 

The third way of executing the user's program ia the GO command. Thia 
command will run the program at full speed. The only way to halt the 
program when uaing CO ia to hit a breakpoint 1 . If we want to run the 
entire program through at full speed a breakpoint ohould be aet at 
5F0E, or the ending inatruction of the program. SFOE contains a JP 
5F0E which is just an endless loop where the program .1umpn after the 
message la through being displayed. To aet the breakpoint entert 

B 2 5 FOR which sets breakpoint 3 at 5F0R 

To start ths program using the GO command key in: 

C 5FO0 

The message should be printed on the screen instantaneously and control 
should bs returned to TASMON. If the breakpoint at 5FOE was not set, 
execution would not ceass and ths program would Jump upon itself until 
the RESET button was pressed. 
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SKSSION 4 

file. 



Write lb* TEST/CMD program owl to di*fc u m Editor/ Astewbkr MNtrce 



The "0" or OUTPUT command is used to accomplish this task. 
The first step is to load TEST/CMP" into memory by entering i 

L D <FNTRR> 

T EST/CMP 

5FO0 5F20 5F00 

Next, enter the OUTPUT command sa follows I 

OP 5F00 5P20 5F00 
TEST/ASM 

The diaaaaembly will be writtan out to disk with the file name TEST/ASH 
Btarting at 5F00 snd ending at 5720 with a tranefer addreaa of 5F00. 
Now exit TASMON by keying ins 

E <ENTER> 

The eyotem will reboot POS." Suppoae you have Apparafs or NISOSYS's 
Editor/Aeaemblera. If you do not have either, I highly recommend the 
purchaae of the MISOSYS version called DISKMOP (which requirea ths 
caaaette E/A sold by Radio Shack). Enter the E/A by typing its fils 
name from POS. 

Next, load TEST/ASM with the "LP" command of Editor/Aaaembler (or 
aimiliar command if uain* a different E/a). As stated previoualy under 
the explanation of the OIJPUT command, the first command to enter is a 
RENUMBER command. TASMON writee out the fils with Una numb are of 
00000 ao thia command la required. To do thia enteri 



N 100.10 



which renumbera the program In increments of 
10 with a starting line number of 100. 



The source listing should bet 



00100 

00110 

00120 Z5F03H 

00130 

00140 

00150 

00160 

00170 

00180 Z5P0EH 

00190 Z5?tlH 

00200 

00210 

00220 



ORG 

LP 

LP 

INC 

CP 

JR 

CALL 

JR 

JP 

LP 

LB 

LP 

LD 



5F00H 

HL.Z5F11H 

A,(HL) 

HL 

OOH 

Z.Z5F0EH 

033AH 

Z5F03H 

Z5F0EH 

P,H 

C.B 

C,C- 

D,E 
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00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 



JR 

LD 

JR 

JR 

LD 

LD 

LD 

DEC 

HOP 

END 



RZ.5F60H 

D,E 

HZ.^BH 

RZ.5F70H 

B,L 

D.B 

D,H 

C 

5F00H 



Rotic. that the -ourca coda hara is tha aama at the J' 1 '*""* ""'J* 
cod. of -TKST/CMD- except that tha labele ara differant and tha text 
meaaa«e now appaara aa Z-80 lnatmctlona. Text meaaagea ara generally 
H« to convert from Z-80 inatructiona back to text. This is done by 
converting the natructlona to numbers. Anyona who has hand assembled 
.pro"™' haa «•<>"• this. Tha only problem exlete when spaces are 
nreeeX in tha text. The code for a apace la 20H, which aleo happens 
?o be the Z-80 inatruction for . "JR NZ.e". The problem doee -t exist 
In finding the apace, but In rinding the character after the apace. 
Th. charlctor after the apace ia the Index of the relative jump minua 
two. 

To determine th. character after the apace (or JR RZ) at line 00230 do 
the following: 

« "Z" in front of the addreaa when making it a label). By doing th a 

inatructiona auch na "LP D.II" are only one byte long. Hpw ** er ^ *^ 
"JR NZ.e" Inatruction la encountered , two muat be nddci to the nddrens 
■ince thia Instruction ia two bytea long. 

low n U btract 5F15 from SFf-0 or more rurally, oubtrnct the n-ldrcna of 
the Jump inatruction from the domination of the Jump. The ranult «f 
thiB eubtraction in our cnoe is 4 PH. 

Row subtract two more from thia value. Thia subra.tion ia "•'«"«£ 
.ince the index of a relative jump is stored in «e-ory ea .he index 
lira two. Subtracting two from 4BH givea 49H, which is nn ASCII I . 

«. "tn n «" mmt: h«> converted back to ASCII by 

TRS-80 ASSEMBLY LANGUAGE PROGRAMMING. 

.„ M1 ,i*r war to fix meaaagea ia to view th. program with an ASCII dump 
An eaaier way xo n* *»"> b .. f the te]t t meaaagea. If a 

from TASMOHand record th. addresses of tne ^ ^^ 

printer i. availabl.. preaeing th. key ill P 

content, to th. prlnt.r thua giving a hardcopy 
dump. i 



listing of th. ASCII 
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SESSION S • Load ■ (.Ml) <fi»k file into memory and write UmiIhi SYSTEM Up*. 



The firat .tap 1. to load tha dlak fil. into Memory. It i. good 
practico to VIEW the file firat. In this example TASHOR i. assumed to 
reaide in memory from EOOO-FFFF. 

To VIEW the file enter: 
V D 

NOVA/CMP 

5CD0 7FE0 5 FOB 

The dlak file "ROVA/CMD" waa VIEWed and th. starting, ending and 
transfer addreaaea were found to he 5C00, 7FE0 and 5F0B respectively. 
Since TASMON reaidea from EOOO-PFFF th. module will not int.rf.r with 
TASMOIf. However, If the module would int.rf.r with TASNOR, th. 
RFLOCATE command could be used to move TASMOR to • location in memory 
where the module would not overlap. 

The next step la to load th. module into memory! 

L D <ENTEP> 

NOVA/CMP 

5C00 7FE0 5F0B 

The last step is io writ. th. SYSTEM tap. out using th. saa. starting, 
ending and transfer addreaaea of the diak fil.t 

W T 5C00 7FE0 5F0B 
NOVA 

The SYSTEM tape waa written out with th. fil. nam. "ROVA". 
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.SESSION 6 - I m- Ihc Til ACE rwnm.nd lo Mrp through ihr il.rt up proccdurr lor HUM 
■ml r*r«-ulf • BASIC program. 

In thia eia.ple TASMON • muet reside in memory from 6000-7FFF and if an 
•inanelon intarfaca ia connactad to tha keyboard, tha EI must be turned 
off The reaW for turning tha EI off i- that tha ROM initialisation 
routine check, if a diak ey.te. ia preeent. In our ei.nple Ha do not 
wish thia. 
Tha firet .top ia to aat tha PC ragietar to OOOOi 

R PC 0000 

Row aat RESTARTS to atepped through nod. by praaaing the "J" keyi 

J I 

Row atart TRACE by typingi 

11 

Tha initialisation routine Mr LEVEL II ROM ia now being traced. The 

■peed of initialisation can be aped up by preaaing the "7 key. 

After a long initialisation procaaa, tha MEMORY SIZE ■aaaaga will 
appear. Enter the following, 

MEMORf SIZE ? 24575 <ENTEP> 

The memory alsa waa aat at 24575 to protect TASMOR. 

We are now tracing through LEVEL II BASIC. Enter tha following 
program: 

10 PRIHT "START" 
20 FOR I - 1 TO 5 
30 PRINT t| i/2{ 1*2 
40 NEXT I 
50 PRINT "PORE" 
60 END 

Row type i 

LIST 

The BASIC program ahould liet upon the acreen. Notice that TASMON ia 
Iontinu.llyJi-pl.ying the regi.tara. Thia ahort program may even be 
HUH from TASMOR* a TRACE mode. 

If a BASIC arror occur., TASMOR " will be eiited ""pl-tily. *• "« thls 
condition • breakpoint «.t U .at at 41B2. Do thia by entering, 
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b liiH 

To eilt BASIC and return to TASMON preaa the BREAK key. Thia must ha 
done before any TASMON command' nay be entered. 

The breakpoint at 41 B2 will occaaionally cauaa TASMON to be reentered. 
To continue stepping BASIC ainply restart tracing aa Ml Iowa « 

ii 

If a BASIC program being run ia to be halted and control returned to 
the BASIC command mode, preaa tha BREAK key and change tha PC regiater 
to 1A1P aa follows i 

R PC 1A19 

Then continue tracing. 

Let 'a atart with a freah acreen by preaaing th. CLEAR k.y. 

Now atart tracing BASIC if not already doing ao. 

Liat the program again by typing: 

LIST ' 

The program ahould list on the acreen. 

To RUN the program type: 

RUN 

Tha meaaage "START" will be printed on th. acreen followed by flv. row. 
of three numbera and th. "END" meaaage. 
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SESSION 7 - ftrlorftle CSF. ■ Mllllljr program by R«cH CompuUt 

CSF is • utility program with routines to ecroll the screen in any 
direction, reverse graphics, dr aw graphics lines, read/write tape 
blocks at high speed end other commands. The Boat noteworthy of the 
commands is the multiple variable sort. 

CSF is a fine program but has one fault, it resides at high memory and 
provides no nay to move itself down in memory. 

Other programs may also need to reside at high memory thus interfering 
with CSF. The solution is to relocate CSF to a new lower loading point 
in memory. 

CSF uses a vectoring technique which fools TASMON'a RELOCATE command. 
Jump addresses for each routine are otored in a table instead of actual 
Z-80 Jump instructions. CSF stores this table In the following formats 



1st byte 

2nd and 3rd bytes 



number of arguments for this routine 
address of this routine 



This Jump table is stored st these locations for the three versions of 
CSF: 



Memory version 

16K 
32K 

4RK 



start of table 

7FB7 
BFH7 
FF07 



end of table 

' 7FFS 
HFFR 
FFFE 



CSF will be relocated normally but the Jump table addresses must be 
changed by hand. The procedure goes as follows! 

Suppose TASHOH resides in memory from 0000-9FFF and the 4RK version of 
CSF is stored on disk with the filename "GSF48/0BJ H . 

The first step is to load CSF into memory* 

L I) <RKTRR> 
C~SF4R/0RJ 
F2DG FFFF FE60 

GSF48/OBJ loads in memory from F2D6 to FFFF. In our example we would 
like GSF to end st FED2 instead of FFFF. We must first find the 
program offset by enteringi 

3 FFFF FED2 - 01 2D 

The new starting and sntry addresses srs found by enteringi 

3 F2D8 01 2D - FtAB 



I fEBO 01 2D - FD53 



new starting address 
nsw sntry address 



Ifow CSF can 
FIAB: 



be relocated to Its new position in memory starting at 



X F2D8 FFFF F1AB 



relocate memory from F2D8 to 
FFFF to memory starting at F1AB 



The starting addrees of the Jump table of the lower memory version of 
CSF must be found by subtracting the offset from the original table 
location: 

3 FF07 012D - FR5A 

The original Jump table must be copied to the new lower memory version 
of CSF* The Jump table may be incorrectly interpreted when relocated 
oinco it i. not normal Z-80 code. As a reault it can not be assumed 
that information oaved at the lower memory CSF is valid. Table data 
Ilea from FF87 to FFFF. for the loaded version of CSF as indicated by 
the nbove table. Thin data is copied to the new lower version as 
iollowa: 

I FFfl7 FFFF FF5A 

To view the Jump table enter: 

H FF5A 

Th<> .jur-p table will be displayed in her on the left side of the screen. 
ip»; rtinplny jiho-jld nppcnr na follows: 



FR9A 02 CC FA 


02 97 FA 03 FQ 


, FF.f>? FA 03 7C 


F3 02 C5 FB 00 


, FEfiA M FB 00 


FB FR 00 01 FC 


FK72 00 1A FC 


02 33 FC O'i 46 


FK7A FC 02 4 A 


FD 03 A7 FD 03 


FK82 17 FR 03 


52 FR 01 62 FR 


FE8A 01 7A FK 


03 FR F4 04 OC 


FK92 F5 02 16 


F5 02 36 F5 03 


FRQA 93 F5 04 


99 F5 01 FC F2 


FRAP 00 FF 00 


FF 00 FF 00 FF 


FKAA 00 FF 00 


FF 00 FF 00 FT 


FRR2 00 FF 00 


FF 00 FF 00 FF 


FKBA 00 FF 00 


FF 00 FF 00 FF 


FRC2 00 FF 00 


FF 00 FF 00 FF 


FFCA 00 FF 00 


FF 00 FF 00 FF 



Hit the BREAK key to reenter command mode. 



Jje J «LM ! J • J" 11 "?* 1 " of th ™ **• wl«M as dssortbed .dots. 

The first set of three is «t FE5A through FE5C. The byt.e at thaas 

addresses are 02, CC and FA reapeetiv.ly. Thaas byta. .« UU^t* 



36 



37 



r"\ 



02 
KACC 



Number of argunenta, Tor this routine 

The adrlreaa of this routine (CC FA ia the Z-80 

format for the addresa FACC) ' 



The neit atep to relocating GSF ia to change all of the junp •«'""" 
to the r correct v.luee. The correct value I. found by auh ra< : ng the 
offaet fro- the original value. The firat one ia done aa followai 

S FACC 012P - F99F 

How the addreaa FACC muat be replaced by F<W. This ia done by 

mollifying memory at the jump table location of FACC at FESB, 

M H FF.5B CC °T 
FE5C FA F9 
FF.5D 02 <BRFAK> 



All of the other routinee are modified in a almiliar manner. Th. .table 
•nda at FFA1 or where the 00 and FF valuea atart appearing. After all 
of t en'trUa have been modified the new veraion of CSF may be a.ved 
to diak. The et-rting, ending and entry addreaeea determined above 
were FUB, FED2 and FD53 reapectivelyi 

V D FUB FED2 FD52 
HFVCSF/OBJ 

The new v.ralon of CSF may be loaded from DOS by typing: 

LOAD NEWGSF/OBJ <KNTER> 

When BASIC ia entered the memory al*e muat be aet to one lea a than the 

Sa. cr, jl^ Jr».TUVmV=: r — ' 

followat 

DEFUSR- 1HFD53 

Th. new r.loo.fd vsrs>on of OSF will function exactly .» the normal 

veraion. 
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MODEL III MANUAL ADDENDUM 

Ho diak commanda are preaent in the current MODEL III 
veraion of TASMON. The formate for the input/output 
commanda are the eame except no distinction between diak or 
tape ia required. For example! 

HODRL I TASMON Load tape command format! 

L T <0FFSET> 

MODEL III TASMON Load tape command format! 
L <0FFSET> 



The other I/O commanda (WRIT 1 ?, VIEW and OUTPUT) ua« the 
aame type of format aa the LOAD command shown above. 



The BREAK key will exit tape I/O with the MODEL III version 
of TASMON. 



The caaaette ia aaved at a baud rate of 1500. If the 500 
baud rate ia dealred, enter the following command: 

M H 4211 01 00 

To set the baud rate back to 1500 enter the following! 

M H 4211 00 0* 
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AITKMHX A 
DOS KIlltOK MESSAGES 



Error number 

00 

01 

02 

03 

04 

05 

06 

07 

OR 

09 

0A 

OB 

OC 

OD 

OF 

OP 

10 

11 

12 

13 

14 

15 

16 

17 

10 

19 

1A 

1B 

1C 

IP 

1E 

1F 

20 

21 

22 

2? 

24 

25 

26 

27-3E 

3F 



Error description 

Ho error 

Parity error during header read 

Seek error during read 

Loat data durinp read 

Parity error durinp read 

Data record not round durinp read 

Attempt to rend system data record 

Attempt to read Bystem data record 

Pevlce not available 

Parity error durinp header write 

Seek error durinp write 

Loat data durinp write 

Parity error durinp write 

Data record not found during writ* 

Write fault on dlak drive 

Write protected dinkette 

Illepal logical file numher (bad DCBJ 

Directory read error 

Directory write error 

Illepal file name (bad DCB) 

GAT rend error 

GAT write error 

HIT reod error 

HIT write error 

File not in directory 

File acceaa denied 

Directory space full 

Pink apace full 

EOF encountered 

HBF out of rile range 

Full directory 

Propram not found 

Illegal drive number 

No device apace available 

Load file format error 

Memory fault 

Attempt to load to ROM 

Illegal access attempted 

File haa not been opened 

Hot defined 

Unknown error code 
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APPENDIX B 
TASMON <:OMMAM> SUMMARY 

This notation is used In the command eummaryt 

HH - 4 diplt hex value 

SS - 4 dipit hex atnrtinp point 

ER - 4 diplt hex endlnp point 

TT - 4 diplt hex transfer point 

n - Single digit from 1 to 9 

h - 2 digit hex value 



A SS 

B n HH 

B <ENTER> 

C n 

C <ENTER> 

D SS 

E <ENTER> 

FSShhbh 

HH 

<EMTER> 

H SS 

I 

J (I or |) 

K SS 

K <ENTER> 

It T 

K'N 



ASCII dump of memory starting at S3. 

Set breakpoint n at HH. 

Display the breakpoints. 

Clear breakpoint n. 

Clear all breakpoints. 

Disassemble memory starting at SS. 

Exit TASMON and return to DOS or BASIC 

Find aearch key h h h h starting at S3. 

Start execution at HH. 

Start execution at user'a PC. 

Dump memory in hex starting at S3. 

Single atep - CALLs stepped through. 

Toggle RESTARTS between stepped through and 
execute in full. 

"Set user'a screen buffer at S3 and clear 
the screen buffer. 

Display the user'a screen for aa long aa tha 
ENTER key ia held down. 

Turn the KEEP SCREEN command on. 

Turn tha KEEP SCREEN command off. 
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l T <offset> 

I D <orr««t> 

"file" 
H H 83 
N A S3 

I n h 

II I 

M <EHTER> 

T S3 EE TT 
file 



D S3 EE TP 
file 



P S3 BE 

R rp HH 
S H1 H2 ♦ 
3 HI H2 - 
T I 



T I 



Y T 



V D 



Load In n SYSTEM tape with optional offset. 

load in CMP disk file named "file" with an 
optional offset. $ 

Modify memory in hex mode starting at S3. 

Modify memory in ASCII mode starting at SS. 

Ret number of execution* for breakpoint ri 
to h. 

Initialled all execution numbers to 01. 

Reset all execution numbers to their default 
values. 

Output dlaaaaeahled listing starting at S3, 
ending at F.E with a transfer address of TT 
to tape with the file name "file". 

Output disassembled listing starting at 83. 
ending at EE with a transfer address of TT 
to disk with the file name file . 

Disassemble to the printer starting at S3 
and ending at EE. 

Replace register pair "rp" with HH. 

Add H? to H1. 

• Subtract H2 from HI. 

Trace through a program with CALLs steppsd 
through. 

Trace through a program with CALLs executed 
In full. 

Go to user routine. Does nothing unless a 
routine is patchod in. 

View a SYSTKM tape. Returns starting, 
ending and transfer addresses without 
loading Into memory. 

View the dlok file titled "file". Returns 
starting, ending and trannfer addreaaes 
without loading into memory. 
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V T S3 EE TT Write a SYSTEM tape starting at S3, ending 
file at EE with a transfer address of TT and file 

name of "file". 

V D SS EE TT Write a CMD disk file starting at S3, ending 
file at EE with a transfer addreaa of TT and file 

name of "file". 

X S3 EE TT Relocate memory from S3 to EE and plaoe It 

in memory starting at TT. 

T SS EE TT Block move from SS to EE and place in Memory 

starting at TT. 

Z S3 EE h Set memory from S3 to EE equal to h. 

RT ARROW Skip current instruction in user's PC and 

point to next instruction. 

LPT ARROW , Back up user's PC to the previous 

instruction. 

* Dump screen contents to the printer. 

DN ARROW 1) Single step - CALLs executed in full 

3) Display next line of a memory dump 
3) Point to next byte when modifying memory 

CLEAR KEY, Clear the screen and display the registers. 

BREAK KEY Return to command mods* 
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App*n<IU C $ 

coaaand had been selected. 

displat thk ust stvfi. "executed nonaction .mi. tr.«i.« win. di.pi.y th. u..r'. 

PC and Z-PO .nenonlc on TASKOR"a display ""••• 
N M 7fTC 00 



and enter th. following bytee fro. therei 



7F7C: 
7FPF.« 
7FA0t 
7FB2i 
7rC4i 
7FPb: 

7rmi 

7FFAi 

enoc: 

601 E I 



00 00 
CA FE 
3? 20 
CD 68 
10 F9 
3A K8 
7D CD 
CP Ffl 
3F CB 
F8 79 



CD 5C 69 
60 18 EF. 
80 C3 34 
71 3E 20 
3A DB 7A 
37 FE 40 
06 80 3F. 
79 23 10 
3P CD 15 
00 00 



CD E3 
CD 5C 
60 3A 
CD 5C 
C9 CD 
DO 3» 
20 CD 
F9 3B 
BO F1 



60 FE 

69 32 
21 00 
69 21 
5C 69 
20 BO 
Ffl 70 
OD CD 
E6 OF 



44 28 OB 

21 80 C3 
B7 20 U 
28 3C 06 
32 20 BO 
BILCfl 2A 
CD E8 79 
E« 79 C9 

C6 30 re 



FE 48 
30 68 
CD OF 
11 7E 
C3 30 
3C 7A 
06 14 
F5 CB 
3A 38 



20 


3E 


FE 


55 


AF 32 


21 


PO 


6" 


2A 3C 


7A 


23 


CD 


PA 


79 


68 


CD 


FA 


60 


7C 


CD' 


06 


80 


21 


28 


3C 7F. 


3F 


CB 3P 


CB 


02 


C6 


07 


C3 



HODIFT ItEHORT In hei ae follows I 



H H 60DE EE 7E 
6*0DF~ ir T0 7F 
60E0 C3 <BREAK> 

H H 6729 FA J2. 
6*72A _r ~60 7F 
672B CD 7EREAK> 

ft H 6855 l5»CJ 
6*856 DB A6 

6657 7A 77 _. 

~~ it rroa this l»»t «e.ory modification until 

K"^." - - """- S.5S •• - «■'• -» "° tak » — " """ 

r H 60F8 4 34 2£ 

6*0F9~ r ~5b 72 

60FA « 3* <BREAIC> 
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To writ* the patched version of TA3K0R out under the fila B* i'ASIIOR/Cirn" , 

•ntar the following comaandt 

V D 6(YX) 7FDP 6HOO 
UPTASMOE/CWP <ESTFR> 

A patched tape vereion can bo written by auhetitutlnc a *T" for the "D" In th« 

VRITE comaand shown above. 

To eiecute the "HARD COPT TRACE" covuaand, preee tha "U" key followed by the "H" key 
for HARD COrt TRACE. Ra»t, antar tha CALL etepplng aodo. Thia la an "1" for CALLe 
ateppad through or a DOW ARROW for CALLa aiacutad in full. 

TA5H0H alii atap through aaaory ■■ •* would with tha TRACK coaaand aieapt tha 
following type output la aent to tha printeri 



8000 I.D 



A,(37E8) 



All TRACE coanand keys function with tha "HARD COPT TRACE" patch. 

Tha DISPLAY LA3T SEVER EXECUTED INSTRUCTIONS patch la aiacutad by preee ing tha "U" 
key and tha "D" key for DIsrLAT LAST SEVER EXECUTED IR3TRIICTI0RS. Re«t, antar tha 
CALL stepping and*. This ia an "I" for CALLa atepped through or a DOVH ARROW for 
CALLa eiecuted In full. 

After each Instruction la eiecuted. Its address and 2-80 aneaonio arc displayed on 
TASKOH's coBjnand llnea. Up to sight previously eiecuted instructions will be 
displayed. 

All TRACE command keys function with the "PISPLAT UST SEVER EXECUTED IRSTRIICTIORS" 
routine. 

Thla patch My ba in a different location for either peat or future vera lone of 
TASHOR. Any future version aay have theae coaaande added to ita repertoire. 

If even Bore uaer routinea era to be added, tha addreaa at 7P8P-7F90 can ba 
aodiried to the atarting address of tha new routine. To eiecuta thia routine prase 
the "U" key to Juap to thia uaer patch and another *U" to Juap to the new routine. 
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